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CHAR PLOT 
Michael Specin^r 



CHAR PLOT is a routine which enables cne to use Che CalConp plotter es a 
versatile output device. It is presently available as CKPLOT SIH (English 
CHAR PLOT) on tape MS 3. 
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The program CHAR PLOT is normally called by a PUSHJ P, PLOTC with a 
code representing a command or character (as defined in Appendix I) in 
accumulator C. Upon calling, the routine will either plot a character or 
line, or perform an internal control function, A code initializes the 
routine* erasing any unexecuted (buffered) commands. 

[Starred portions of this nemo, explain the items necessary to use 
the routine for most purposes. Other portions describe sore (less needed) 
options*] 



*Th£ CALCOMP PLOTTER 

The CdlComp plotter is an Incremental xy plotter which is capable of 
horizontal and vertical incrementing by .005 inch. Incrementing can be done 
Separately (ii.ij) or together (liij), where I and j are unit (,005 inch) 
vectors in the -t-X and +Y directions* respectively. Thus 8 directions of 
motion are possible: 
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Note that the plotter has no way of detecting where the pen Is with respect 
to the paper* Pen notion requested past the edge of the paper is ignored 
by the plotter, but this should not be relied upon for exact positioning. 

*CCWVEOTIONS 

Radices. All Integers are octal; all other nuabers are decimal. 
Relative units. 1 relative unit ■ SCALE * 1 absolute unit (.005 inch). 
Characters are plotted in relative units and vectors may also be so plotted. 

Directions and Apparent Axes. The apparent axes may be set in one of 
eight possible orientations with respect to the plotter axes (see Appendix I, 
codes 30 - 37), Directions (R t U,L,D,UR>cT f DL,DR) are with respect to the 
apparent axes unless otherwise specified. 

parentheses around a symbol wean "contents o£". 

*CL0BAL SYMBOLS 

PLOTC Normal entry point. 

CHARPL Entry point which treats the 8 low-order bits of accumulator 

C as a character code regardless of the rest of accumulator C. 

CCTAB Beginning of upper-case table. 

LCTAB Beginning of lover-case table (-20DKJCTAB). 

CLNCTH Routine (called by PUSHJ ?, CLNGTH) which returns la C the 

length (in relative units) of the non-control character whose 
code was its argument in C. Upper and lower case can be 
specified using the 200 bit or by calling CLNGTH with 16 and 17 
codes to change case. 

Current coordinates of pen in absolute units with respect to the 
apparent axes. Initially (X)«(Y)"0. Not initialized by code, 

SCALE Number of absolute units (.005 inch) in a relative unit- 

Characters are always plotted in relative units, and vectors 
nay be so plotted. 
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Location for return from crock Interrupt. 



See DEFINE CHAR command (With the transfer bit 1....). 



Crock PI channel. (1* CEtKCHN* 7) 

Length of data buffers. Unless otherwise specified they are 
both 1000. However, they may be as little as 1 each. 
4*LBlfFF5LWBUFF, otherwise storage is wasted. LBUFF<200000. 

Push-down pointer. (1*P*17) 

Argument accumulator. (l€C6l7) 



*C~AfiACTERS 



For plotting a character , the input to the routine is a word whose 8 
low-order bits contain an ASCII-type code (see Appendix I) and whose sign 
bit aust be 0. For a normal character, the pen is assumed to be raised and 
is left raised; the character is plotted with its lower left corner at the 
initial position of the pen, and the pen is left ready for plotting the next 
character. 

Characters may be in upper or lower case- The case of a character is 
specified in one of two ways: codes 16 and 17 may be used to shift case, 
character codes being interpreted in the current case; or while the routine 
is in upper case* the 200 bit of a character code may be or 1 to specify 
upper or lower case, respectively. Note that when in lower case, character 
codes should have the 200 bit 0. The program starts in upper case (initialized 
by code) and it is suggested that the 200 bit be used to specify case rather 
than shifting case with the 16 and 17 codes. 

*VECT0RS AM) CONTROL FUNCTIONS 

For plotting vectors and for performing control functions, the input to 
the routine is a word whose sign bit is 1. The high-order bits of this word 
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Are interpreted 

bit 0-^ 
10 
110 
1110 
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follows : 

xy-f on&at . 

Define CHAR/CHAR SET. 

Go to effective address at process time with all 

accumulators restored to their value before the last 

interrupt. (To return to CHAR PLOT use JRST 12,SCRKBRK , \) 

Half-word format. 



*XY-?ORMAT 



bits: 
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x ar.d y are interpreted as 20-bit 2'i 
The code is interpreted as follows: 
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Set (X) and (Y) . Set <X) to x and (V) to y. 

Does not move pen. 

Increment (x > y) with scale. Move the pen as specified 

by the vector SCALE* (x»y), i.e. x relative units R 

and y relative units U. 

Increment (x,y) without scale. Move the pen as specified 

by the vector (x,y), i.e. x absolute units R and y 

absolute units R and y absolute units U. 

Co to (x»y). Move the pen to the point (x,y). 
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If the transfer bit is 0, the address and pointer refer to a word end 
position within the word of the first four-bit byte of the character to be 
specified by the character code. They are placed in the proper positions of 
a byte pointer which then defines the character. The byte-length is set to 
four automatically. The word or words containing the bytes are set up as 
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follow: 



IaxUtI 1 I— lo t 



Ax sod Ay are respectively the changes in (X) and in (V) produced by plotting 
the character, measured in relative units. They are interpreted as positive 
4-bit quantities Either or both nay be 0, The first after Ax end £y 
terminates the string. The codes for bytes ate as follows: 

2 Pen Up 

4 Pen Down 

5 Dot Down (plots a dot at current pen position) 

10 Right one relative unit 

11 Up one relative unit 

12 Left one relative unit 

13 Down one relative unit 

14 m 

15 JJl 

16 DL 

17 DR 

With the transfer bit 1, the pointer bits are placed as in a byte pointer, 
bit 14 is set to lj the address retrains, and resulting word defines the charac- 
ter to be specified by the character code. When the character is used, the 
routine transfers tothe address (without dismissing the interrupt) vith the 
character-defining word remain ins in accumulator C, Returns to CHAR PLOT 
supplied are SEWC (continue) , SETC (which plots the character whose defining 
word is in accumulator C, then continues), and SETW (which interprets the word 
in accumulator C as if it were an argument to PLOTC with bit 0-1, then 
continues). SCALE, X, and Y are global and eo can be modified and/or tested 
before return* In addition, if the user defines a global symbol PP (a location 
containing a special push-down pointer), he may cell a subroutine SU3PL7 which 
works like PLOTC, only in interrupt node, and thus performs the command which 
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is its argument immediately. An example of its use would bo; 

EXCH P> PP 
Mora C, IW0RD1) 
PUSHJ ?, SUBPLT 
MOVE C, (W0RD2) 
PUSHJ P, SUBPLT 
EXCH P, PP 
JRST HEtfC 

The EXCH P, PP instructions arc necessary sir.ee SUBPLT also executes 
these instructions before dismissing the interrupt and before returning to 
the calling program* 

Thus a new character may be defined. Once defined, the character may be 
used in the normal Banner. 

The Define CHAR SET feature enables the user to define a complete set of 
characters. The 8 bits for character code being specify this feature. The 
address is that location which is the beginning of a character table of words 
defining characters, with the first location defining the character with code 
0, the second defining code 1, etc. Once a set Is so defined* it is the only 
one addressable. In order to return to the original set, one may use a Define 
CHAR SET with UCTAB as the address. 



*HALF-yORD FORMAT 
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The code is interpreted as follows; 
Set scale to n* 



Set horizontal tab to n. This sets tabs at n» 2n, 3n, etc. 
(to be interpreted in relative units). Initially 40, 

Set line feed length to n (to be interpreted in relative 
units). Initially set for single space at 9. 
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Set vertical tab. (like horizontal tab) 
Set (X) to n.j 

Set (V) to n. n interpreted as 22-bit 
Go to (X)=n. 2's conplemer.t nuaber. 

Go to (Y)=n. 
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APPENDIX I* 



•INITIAL CHARACTER SET 

code upper case/lower case (add 200 co code If In upper case) 

(If no entry, sane as upper case) 

illegal character /illegal character if In lower case 

1 pen down 

2 subscript 

3 pen up 

4 superscript 

5 enter x&ode with no pen controls executed 

6 leave mode with no pen controls executed 

10 sex scale to zero (1 is first usable scale) 

11 horizontal tab 

12 line feed 

13 vertical tab (will not go past a page boundary) 

14 form feed (pages are 4000 absolute units long) 

15 carriage return 

16 shift into upper case 

17 shift into lower case 

20 add 2^ to scale/subtract 2° from scale 

21 add 2^ to scale/subtract 2* from scale 

22 add 2 2 to scale/subtract 22 from scale 

23 add 2^ co scale/subtract 2~ from scale 

24 add 2 4 to scale/subtract 2* froa scale 

25 add 2J? to scale/subtract 2~ fron scale 

26 add 2* to scale/subtract 2* fron scale 

27 add 2 7 to scale/subtract 2 from scale 

30 orient apparent x-axis along plotter x-axis tj - 

31 orient apparent x-axis along plotter y-axis * 

32 orient apparent x-axis upside down along plotter x-axis ^ 

33 orient apparent x-axis upside down along plotter y-axis f 

34 orient apparent x-axls backwards along plotter x-axis f 1 * 

35 orient apparent x-axis backwards along plotter y-axis t 

36 orient apparent x-axis upside down and backwards along 

plotter x-axis -JJ 

37 orient apparent x-axis upside down and backwards along 

plotter y-axis T 

[Note that when one of the codes 30-37 is executed, (X) and 
<Y) are changed. The point (2000,2000) is a fixed point in 
this transformation-] 
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code upper case lover case 
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one*db solute unit 
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set <x> and <y) 

increment: v/ scale 
increment h017t scale 

GO TO (x,y) 



bit: 
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pointer t.b> 
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address 
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DEFINE CHARACTER 
DEFIHE CHAR SET 



bit: 
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SIT SCALE 
SET H0&. TAB 
SET LIME FEED 
SET VERT- TAB 
SET (X) 
SET (Y) 
GO TO <X)=n 
GO TO (V)=n 
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